home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 14 / CU Amiga Magazine's Super CD-ROM 14 (1997)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1997-09].iso / CUCD / Programming / SAS-C / sc655pch / guiprof / READ.ME < prev    next >
Encoding:
Text File  |  1995-01-26  |  3.5 KB  |  82 lines
  1. GUIPROF utility source code Copyright (c) 1993-1995 SAS Institute, Inc.
  2. All Rights Reserved.
  3. -----------------------------------------------------------------
  4.  
  5. [[[FOR A QUICK DEMO: from WorkBench, click on "guiprof", then shift-double
  6. [[[click on "test".  From CLI, type "guiprof test".  8^)
  7.  
  8. This directory contains the source code to a GUIPROF, a graphical version
  9. of the SPROF utility.  GUIPROF basically receives messages from the 
  10. executable being profiled each time a function is entered or exited.  It 
  11. accumulates time information and displays the results as one of four
  12. possible histograms.
  13.  
  14. Syntax:
  15.  
  16.    GUIPROF <prof options> [<program> [<program options>]]
  17.  
  18. The <prof options> portion of the above command line adheres to the
  19. following AmigaDOS command template:
  20.  
  21.    GUIPROF ?/S,HELP/S,WAIT/S,FULLNAMES/S,FORCE/S,AXIS/S,INTERVAL/N,
  22.            SORT,FORMAT,VERBOSE/S,AUTOEXIT/S
  23.  
  24. where the various options are described below:
  25.  
  26.           ?
  27.        HELP
  28.                Print usage information to the console and exit.
  29.  
  30.        WAIT
  31.                If WAIT is specified, the profiler will wait until a
  32.                program compiled with the PROFILE option is run, then
  33.                profile that program.  If you specify WAIT, you do not
  34.                need to specify a program name on the command line.  You
  35.                must specify either WAIT or the program name, however.
  36.        
  37.   FULLNAMES
  38.                Causes the profiler to use full names for the functions
  39.                profiled.  The full name is of the form
  40.                
  41.                   \module\function\line
  42.                
  43.                where "module" is the name of the source file containing
  44.                the definition of the function, "function" is the name
  45.                of the function, and "line" is the source file line number
  46.                of the end of the function.  If FULLNAMES is not specified,
  47.                just the "function" portion of the name is used.
  48.                   
  49.       FORCE
  50.                Forces status reports, at a cost to the program.  Normally,
  51.                the profiler waits until the program signals it before it
  52.                updates the display.  This allows the display update to take
  53.                place without affecting the timing statistics.  If you
  54.                specify FORCE, the display will be updated whether or not
  55.                the program has been suspended.  This means that the program
  56.                being profiled will be competing with the profiler for time,
  57.                so you don't normally want to specify this flag.
  58.       
  59.        AXIS
  60.                Adds a horizontal axis to the histogram.
  61.  
  62.    INTERVAL=time
  63.                Report interval, in milliseconds.  Default 250.  A report
  64.                will be generated at most every INTERVAL milliseconds; it
  65.                may be longer if FORCE is not specified, since the profiler
  66.                will wait until the next function entry or exit point before
  67.                updating the display.
  68.  
  69.        SORT=type
  70.        
  71.                Either ALPHA or NUM, for alphabetic or numeric sort.
  72.  
  73.      FORMAT=fmt   
  74.                Report format.  Format is one of
  75.                     PCT:   Percentage of time spent in routine.
  76.                     ETIME: Milliseconds in routine, excluding subroutines.
  77.                     ITIME: Milliseconds in routine, including subroutines.
  78.                     COUNT: Number of times routine was called.
  79.  
  80. Other than described above, the GUIPROF program works like the SPROF
  81. program described in your SAS/C User's Guide.
  82.